home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmdumplog.z / pmdumplog
Encoding:
Text File  |  2002-10-03  |  9.3 KB  |  198 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))                                                      PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmdddduuuummmmpppplllloooogggg - dump internal details of a performance metrics archive log
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmdddduuuummmmpppplllloooogggg [----aaaaddddiiiiLLLLllllmmmmrrrrssssttttzzzz] [----nnnn _p_m_n_s_f_i_l_e] [----SSSS _s_t_a_r_t_t_i_m_e] [----TTTT _e_n_d_t_i_m_e] [----ZZZZ
  13.      _t_i_m_e_z_o_n_e] _a_r_c_h_i_v_e [_m_e_t_r_i_c_n_a_m_e ...]
  14.      ppppmmmmdddduuuummmmpppplllloooogggg [----vvvv _f_i_l_e]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ppppmmmmdddduuuummmmpppplllloooogggg dumps assorted control, metadata, index and state information
  18.      from the files of a Performance Co-Pilot (PCP) archive log.  The archive
  19.      log has the base name _a_r_c_h_i_v_e and must have been previously created using
  20.      ppppmmmmllllooooggggggggeeeerrrr(1).
  21.  
  22.      Normally ppppmmmmdddduuuummmmpppplllloooogggg operates on the distributed Performance Metrics Name
  23.      Space (PMNS), however if the ----nnnn option is specified an alternative local
  24.      PMNS is loaded from the file _p_m_n_s_f_i_l_e.
  25.  
  26.      If any _m_e_t_r_i_c_n_a_m_e arguments appear, the report will be restricted to
  27.      information relevant to the named performance metrics.  If _m_e_t_r_i_c_n_a_m_e is
  28.      a non-leaf node in the namespace (see ppppmmmmnnnnssss(4)), then ppppmmmmdddduuuummmmpppplllloooogggg will
  29.      recursively descend the archive's namespace and report on all leaf nodes.
  30.  
  31.      The options control the specific information to be reported.
  32.  
  33.      ----aaaa   Report everything, i.e. the flags ----dddd, ----iiii, ----llll, ----mmmm, ----ssss and ----tttt.
  34.  
  35.      ----dddd   Display the metadata and descriptions for those performance metrics
  36.           that appear at least once in the archive:  see ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for
  37.           more details on the metadata describing metrics.
  38.  
  39.      ----iiii   Display the instance domains, and any variations in their instance
  40.           members over the duration of the archive: see ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3) for more
  41.           details on instance domains.
  42.  
  43.      ----llll   Dump the archive label, showing the log format version, the time and
  44.           date for the start and (current) end of the archive, and the host
  45.           from which the performance metrics values were collected.
  46.  
  47.      ----LLLL   Like ----llll, just a little more verbose.
  48.  
  49.      ----mmmm   Print the values for the performance metrics from the archive.  This
  50.           is the default display option.
  51.  
  52.           Metrics without an instance domain are reported as:
  53.             [_t_i_m_e_s_t_a_m_p] _m_e_t_r_i_c-_i_d (_m_e_t_r_i_c-_n_a_m_e): vvvvaaaalllluuuueeee _v_a_l_u_e
  54.  
  55.           Metrics with an instance domain are reported as:
  56.             [_t_i_m_e_s_t_a_m_p] _m_e_t_r_i_c-_i_d (_m_e_t_r_i_c-_n_a_m_e):
  57.                 iiiinnnnsssstttt [_i_n_t_e_r_n_a_l-_i_d oooorrrr "_e_x_t_e_r_n_a_l-_i_d"] vvvvaaaalllluuuueeee _v_a_l_u_e
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))                                                      PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))
  71.  
  72.  
  73.  
  74.           The _t_i_m_e_s_t_a_m_p is only reported for the first metric in a group of
  75.           metrics sharing the same timestamp.
  76.  
  77.      ----rrrr   Process the archive in reverse order, from most recent to oldest
  78.           recorded metric values.
  79.  
  80.      ----SSSS   When using the ----mmmm option, the report will be restricted to those
  81.           records logged at or after _s_t_a_r_t_t_i_m_e.  Refer to PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a
  82.           complete description of the syntax for _s_t_a_r_t_t_i_m_e.
  83.  
  84.      ----ssss   Report the size in bytes of each physical record in the archive.
  85.  
  86.      ----TTTT   When using the ----mmmm option, the report will be restricted to those
  87.           records logged before or at _e_n_d_t_i_m_e.  Refer to PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a
  88.           complete description of the syntax for _e_n_d_t_i_m_e.
  89.  
  90.      ----tttt   Dump the temporal index that is used to provide accelerated access
  91.           to large archive files.
  92.  
  93.           The integrity of the index will also be checked.  If the index is
  94.           found to be corrupted, the ``*.index'' file can be renamed or
  95.           removed and the archive will still be accessible, however retrievals
  96.           may take longer without the index.  Note however that a corrupted
  97.           temporal index is usually indicative of a deeper malaise that may
  98.           infect all files in a PCP archive.
  99.  
  100.      ----vvvv   Verbose mode.  Dump the records from a physical archive file in
  101.           hexadecimal format.  In this case _f_i_l_e is the name of a single file,
  102.           usually a basename (as would otherwise appear as the _a_r_c_h_i_v_e command
  103.           line argument), concatenated with ``.'' followed by one of mmmmeeeettttaaaa (the
  104.           metadata), iiiinnnnddddeeeexxxx (the temporal index), or a digit (one of the
  105.           volumes of metric values).
  106.  
  107.           Use of ----vvvv precludes the use of all other options and arguments.
  108.  
  109.      By default, ppppmmmmdddduuuummmmpppplllloooogggg reports the time of day according to the local
  110.      timezone on the system where ppppmmmmdddduuuummmmpppplllloooogggg is run.  The ----ZZZZ option changes the
  111.      timezone to _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as
  112.      described in eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local
  113.      timezone at the host that is the source of the performance metrics, as
  114.      specified in the label record of the archive log.
  115.  
  116. FFFFIIIILLLLEEEESSSS
  117.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss////*
  118.                default local PMNS specification files
  119.      $$$$PPPPCCCCPPPP____LLLLOOOOGGGG____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr_h_o_s_t_n_a_m_e
  120.                Default directory for PCP archives containing performance
  121.                metric values collected from the host _h_o_s_t_n_a_m_e.
  122.  
  123.  
  124.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))                                                      PPPPMMMMDDDDUUUUMMMMPPPPLLLLOOOOGGGG((((1111))))
  136.  
  137.  
  138.  
  139. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  140.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  141.      file and directory names used by PCP.  On each installation, the file
  142.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  143.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  144.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  145.  
  146. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  147.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmllllooooggggcccchhhheeeecccckkkk(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1),
  148.      ppppmmmmllllooooggggggggeeeerrrr____ddddaaaaiiiillllyyyy(1), ppppmmmmllllooooggggmmmmeeeerrrrggggeeee(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3),
  149.      ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3), ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and ppppmmmmnnnnssss(4).
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.